楽天ペイV2決済フロー
※随時決済の「利用承諾のみ」「利用承諾+都度決済」は都度決済の各APIを利用して行います。
そのため、「利用承諾のみ」「都度決済+利用承諾」の流れは都度決済と同様の流れとなります。
決済の流れ(都度決済)
楽天ペイV2で決済を行う際の流れです。
sequenceDiagram
お客様->>加盟店様: 1.楽天ペイで支払う
加盟店様->>当サービス: 2.取引登録
当サービス-->>加盟店様:
加盟店様->>当サービス: 3.決済実行
当サービス->>楽天: 4.決済要求
楽天-->>当サービス:
当サービス-->>加盟店様:
加盟店様-->>お客様:
当サービス-->>加盟店様: 結果通知（非同期）
お客様->>当サービス:5.支払い手続き開始
当サービス-->>お客様:
お客様->>楽天:
楽天-->>お客様:6.楽天ログイン画面表示
お客様->>楽天:7.楽天IDでログイン
楽天-->>お客様: 決済画面表示
お客様->>楽天:8.クレジットカード選択、ポイント指定、支払同意
楽天-->>当サービス:9.決済結果返却
当サービス->>楽天:10.決済完了要求
楽天-->>当サービス:
opt 11.決済リトライ（決済失敗かつリトライ有効の場合）
当サービス-->>お客様: 決済画面にリダイレクト
お客様->>楽天: 決済画面表示
お客様->>楽天: 利用クレジットカード、ポイント指定、支払同意
楽天-->>当サービス:
当サービス->>楽天:決済完了要求
楽天-->>当サービス:
end
当サービス-->>加盟店様: 結果通知（非同期）
当サービス-->>お客様: 12.戻りURLにリダイレクト
お客様->>加盟店様:
opt 13.決済キャンセル（在庫の引き当てができなかった場合）
加盟店様->>当サービス: キャンセル
当サービス->>楽天:
楽天-->>当サービス:
当サービス-->>加盟店様:
当サービス-->>加盟店様: 結果通知（非同期）
end
加盟店様-->>お客様:支払完了画面表示
フローの説明
- お客様がお支払い手段に楽天ペイ決済を選択します。
- 加盟店様は当サービスの取引登録（EntryTranRakutenpay）を行います。
- 加盟店様は当サービスの決済実行（ExecTranRakutenpay）を行います。
- 当サービスは、楽天に対し決済要求を行います。
- 加盟店様はお客様を当サービスの支払手続き開始IF（RakutenpayStart）に誘導します。
- お客様のブラウザ上から当サービスの支払手続き開始IF（RakutenpayStart）が行われ、お客様に楽天ログイン画面を表示します。
- お客様は楽天にログインします。
- お客様はお支払いに使用するクレジットカード・楽天ポイント等を入力し、決済を行います。
- 楽天から決済結果が返却されます。
- 当サービスは楽天に対し決済完了要求を行います。
- 決済結果が失敗の場合、リトライが有効であれば、お客様は再度決済方法を選び直し決済することができます。
- 当サービスは加盟店様の決済結果戻しURLに決済結果を返却します。
- 加盟店様は在庫引き当てができない場合キャンセルを行います。
決済の流れ(随時決済)
楽天ペイV2で随時決済を行う際の流れです。
sequenceDiagram
加盟店様->>当サービス: 1.取引登録
当サービス-->>加盟店様:
加盟店様->>当サービス: 2.決済実行
当サービス->>楽天: 3.決済処理
楽天-->>当サービス:
当サービス-->>加盟店様:
当サービス-->>加盟店様:結果通知(2.決済実行)
フローの説明
- 加盟店様は当サービスの取引登録（EntryTranRakutenpay）を行います。
- 加盟店様は「利用承諾のみ」「都度決済+利用承諾」に発行されたサブスクリプションIDを指定し、決済実行（ExecTranRakutenpay）を行います。
- 当サービスが楽天に対して決済処理を行い、加盟店様に決済結果を返却します。
楽天ペイ注文ボタン生成について
楽天ペイ注文ボタンを設置可能です。JavaScriptコードを支払ページに埋め込んで、ボタンを表示させてください。
「楽天IDでお支払い」というボタンが表示されます。
※ JavaScriptは、ボタンを表示させる機能のみを提供しており、Submit等の動作をする機能は提供していません。
注文ボタンを押下後に決済実行を呼び出すことを推奨しております。
「楽天ペイ注文ボタン生成について」は楽天ペイのドキュメントを参照しております。詳細は楽天ペイへお問い合わせください。
設定値
| データ型 | 必須 | 説明 | |
|---|---|---|---|
| src | 文字列 | Y | 注文ボタンを作成するための設定値。 固定値： 'https://contents.online.checkout.rakuten.co.jp/live/button/v1/rakuten-pay.js' |
| class | 文字列 | Y | 注文ボタン作成するための設定値。 固定値：'rakuten-checkout-button' |
| data-button-type | 文字列 | N | 注文ボタンのデザインを指定する設定値。 現在提供しているデザインは"default"のみ。 |
| data-button-width | 数字 | N | 注文ボタンのデザインを指定する設定値 指定できる範囲：165～640 指定されていない場合は 240になる。 範囲外の値が指定された場合は、限界値のサイズになる。 |